Progress Output
For some files, a CLI command may take a considerable time to process. Where the underlying component provides feedback to the CLI, progress will be output with a standard Progress Line. The line will begin with the text "Progress(<label>)", where "<label>" indicates the component/subsystem providing the feedback, with one dot (".") being added for every 3% of progress. A maximum of 35 dots will be output. When complete, the line will end with "done". For example:
/home/frodo/cgicc_diff_clean/src/diff/version.c:qac:0:1:1
/home/frodo/cgicc_diff_clean/src/diff/util.c:qac:0:2:0
/home/frodo/cgicc_diff_clean/src/cgicc/CgiEnvironment.cpp:qacpp:0:1:2
/home/frodo/cgicc_diff_clean/src/cgicc/CgiUtils.cppgit push:qacpp:0:2:1
/home/frodo/cgicc_diff_clean/src/cgicc/Cgi.cpp:qacpp:0:3:0
Progress(CMA): ................................... done
Each output line is colon-separated and uses the following format:
<pathname>:<component>:<return code>:<# files analyzed>:<# files yet to be analyzed>
where:
- pathname is the absolute pathname of the file that was analyzed.
- component is the abbreviated name of the component (for example qac).
- return code is the code returned from the analysis by the component. A non-zero value indicates an error.
- # files analyzed is the incrementing total of the number of files analyzed so far by the CLI command.
- # files yet to be analyzed is the decrementing total of the number of files that remain to be analyzed by the CLI command. This number will count down to zero.
Any whole project analysis components that provide progress feedback (such as RCMA and Dataflow) now also output messages of progress notification. These mid-analysis, interim messages do not contain a return code, for example:
/home/frodo/single_project_rcma:rcma::1:125
/home/frodo/single_project_rcma:rcma::56:70
/home/frodo/single_project_rcma:rcma::100:26
However, on completion of the analysis, the return code will be populated as usual, for example: